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SUMMARY 


Using the digital computer in real-time aircraft propulsion control systems re- 
quires extensive use of assembly-language programming. Because this language is far 
removed from the actual control equations, significant control-software evaluation and 
debugging problems often occur. Therefore, software is needed to alleviate these 
problems . 

Presently available debug software is not sufficient to raise operator-computer in- 
teraction to the level where software evaluation and debugging become acceptable. 
Therefore, a higher level debug program was developed. This program uses informa- 
tion supplied by the computer's assembler and loader and by the operator to simplify 
problem recognition and to permit straightforward modifications to the software being 
debugged. 

Addressing techniques are used that allow operator-computer interaction by mea.ns 
of easily recognizable names and relative addresses as they appear in the source list- 
ing. Many data formats are available, including one that specifies data in engineering 
units. An instruction coder and decoder allow program instructions to be specified by 
their assembler mnemonic representation and to be evaluated during execution of the 
program that is to be debugged. Thus, the operator need not be concerned with actual 
machine coding. Execution terminators are included that, when used, will stop debug 
execution of the program if certain prespecified conditions are encountered. The oper- 
ator may specify execution termination when conditions are encountered that modify the 
program counter or the selected memory locations or that cause arithmetic overflows. 
Other features incorporated into the debug program include an on-line assembler that 
makes it easier to modify the program that is to be debugged. 

The debug program is described in detail in this report. The debug commands, 
their sequencing, and their options are described and illustrated. Functional dia- 
grams of the debug program are given in the appendix. 


INTRODUCTION 

Recent advances in digital computer hardware have enhanced its use in control ap- 
plications. Controls requiring extensive computations and logical decisions, such as 
those for modern aircraft propulsion systems, are particularly well suited for imple- 
mentation on a digital computer. Aircraft propulsion controls, however, are usually 
bound by stringent computation-time limits. 


Computation speed depends on the programming language used to implement the 
control equations. In general, the more removed the programming language is from the 
basic machine instruction set, the slower is its computation. Therefore, computation- 
time limits often preclude the use of higher order languages that offer a format close to 
the actual control equations and force the programmer to use assembly language. Be- 
cause assembly language is far removed from the actual control equations, significant 
program debugging problems may be encountered. 

Debugging consists of analyzing and modifying the assembly-language program . It 
may be done through direct operator-computer interaction, which is itself very prone to 
error because of the bookkeeping involved, or through a buffer program that raises this 
interaction to a more comprehensible level. Although such programs (referred to as 
debug programs) are usually available with every computer, they are generally not ex- 
tensive enough to meet the needs of the control-system programmer. The debug pro- 
gram described in this report offers more versatile addressing, display, execution, 
and on-line assembly capabilities than previous debug programs. It was written for the 
Honeywell HDC-601 flight-qualified computer and the Honeywell DDP-516/316 compu- 
ter. The philosophy and techniques used in developing the program are described in de- 
tail so that the concepts can be applied to other computers. Because this report is also 
intended as a users guide, operational details and examples are given. 

The control-software debugging process requires operational data for software 
evaluation. These data are generally collected by running the software in conjunction 
with the system to be controlled (or a real-time simulation of the system) . The data- 
collection process is made simpler by a data-collecting and display program called 
INFORM (ref. 1). This program is a high-level, operator-computer interaction pro- 
gram described in this report offers more versatile addressing, display, execution, and 
on-line assembly capabilities than previous debug programs. It was written for the 
software evaluation and modification capabilities to the control programmer. 


GENERAL CONSIDERATIONS 

The debug program was written for the Honeywell HDC-601 flight-qualified com- 
puter and the Honeywell DDP-516/316 computer. The program depends on the compu- 
ter architecture and instruction set. The computers are described in detail in refer- 
ences 2 and 3. The HDC-601 uses a 16-bit word with the most significant bit designated 
as bit 1. The computer has four manipulative registers; 

(1) A register (AREG) - the primary arithmetic and utility register 

(2) B register (BREG) - the secondary arithmetic register 

(3) X register (XREG) - the index rigister 

(4) KEYS - the register used to contain machine status information 
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The computer uses sectorized addressing: Memory is divided into 512-word sectors. 
Communication within a sector is done directly, but communication between sectors 
must be done indirectly through intersector references. The one exception is that com- 
munication with the first memory sector can be made directly from any sector. Inter- 
sector references, therefore, can be stored in the first sector. The computer's assem- 
bler and loader also allow an area within each sector to be set aside for intersector ref- 
erences. This area is referred to as the sector base area. 

The HDC-601 instruction set can be divided into two categories: those requiring an 
operand, and those not requiring an operand. Instructions requiring an operand are 

(1) Memory reference instructions 

(2) Input-output instructions 

(3) Shift instructions 

Each instruction has a three-character, assembly-language mnemonic representation 
and a machine-language operational code (op-code). These considerations and those of 
the preceding paragraph are important to the structuring of the debug program and must 
be considered in using the program concepts to formulate debug programs for other 
digital computers. 

The basic philosophy of the debug program development was to use assembler-, 
loader-, and operator-supplied information to provide operator-computer interaction in 
an understandable format. The assembler supplies a source listing and a t^le of 
source names. The debug program uses these names to simplify operator address 
recognition. The loader supplies the relocation base addresses and the locations of 
sector base areas. The debug program uses them to eliminate the need for absolute 
address specification and to efficiently automate program modifications. Through 
INFORM, the operator may assign scale factors and names to memory addresses. This 
allows data to be specified directly in engineering units. 

The computer's instruction set is incorporated into the debug program. Because 
both the mnemonics and the op-codes are included, program modifications can be 
structured in assembly language without resorting to machine coding. Conversely, 
machine coding for program listings can be automatically interpreted in an easily under- 
standable format. 

Because the command structure of the debug program is fully compatible with the 
command structure of INFORM (ref, 1), the programmer can incorporate any INFORM 
commands with any debug commands for an evaluation and modification program that 
suits his needs. 
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DEBUG PROGRAM CAPABILITIES 


The capabilities of the debug program are 

(1) Initialization 

(2) Addressing 

(3) Information display 

(4) Program modifications 

(5) Execution and analysis 

Each capability is discussed in general in this section to give an understanding of the 
program concepts. Detailed program descriptions and operational examples are given 
in subsequent sections. 


Initialization 

The debug program must be initialized before execution to provide the information 
necessary to its operation. That is, memory areas must be specified to contain 

(1) The debug name tables (source names assigned to addresses within the program 

to be debugged) 

(2) The debug on-line assembler's buffer (the area used to assemble operator- 

supplied instructions) 

(3) Program additions (the area assigned for additions to the program being de- 

bugged) 

(4) The INFORM name tables (names and scale factors assigned to any memory 

address when INFORM commands are being used) 

In addition, the operator may specify a protected memory area that cannot be violated 
during debug execution of his software. After memory-area assignments are speci- 
fied, the operator may specify the sector base areas and fill the name tables. The de- 
bug name tables may be filled manually (e.g. , keyboard) or automatically (e.g. , paper 
tape) by entering the table of source names obtained during assembly of the program 
that is to be debugged. Any number of programs or subroutines can be debugged simul- 
taneously, and the source-name assignment is limited only by the area set aside. 


Addressing 

Flexible operator-address specification is offered in the debug program . It allows 
referencing of an absolute octal address, a source name, an INFORM name, and a re- 
locatable octal address. Arithmetic-address stringing is permitted in combinations of 
the preceding. In addition, special addressing - including undefined addressing, index- 
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ing, and indirect address specification - is available for instruction operands during 
on-line assembly. 

Two locations, called the first and last address counters, are used to specify the 
initial and final address limits for debug commands. The first address counter is also 
used to establish the base address for address displacements. When a source name or 
a relocatable octal address is specified, the first address counter is used to determine 
which progran'i is being debugged and which source-name table is referenced. The re- 
location base for this program (specified during initialization) is added to the specified 
address to form the absolute address. With this address mode the operator may easily 
work from the source listing of the program currently being debugged. An address for- 
mat is available to reference names external to the current program. 


Information Display 

An information display package is contained in the debug program. Any of the four 
registers (AREG, BREG, XREG, and KEYS) or any memory location or series of mem- 
ory locations can be displayed in an operator-selected format. Display formats are 
available for octal integers, decimal single- and double-precision integers, and decimal 
floating-point numbers. (Because all decimal displays can be descaled, the display can 
be in engineering units.) Display formats are also available that specify the address as 
containing ASCII characters or a direct-address constant. 

Additional display formats are available for memory display only. Display of the 
effective address of a direct- address constant (deciphering of the indirect chain) and 
display of block-zero storage (the number of successive addresses containing zero) may 
be specified. In addition, the address may be specified to contain an instruction that 
will cause the display of the mnemonic and operand, if any. If the instruction is a 
memory-referencing instruction, the status of the index and indirect indicators is also 
displayed. 

Two display modes are available: the print mode and the list mode. The print 
mode simply lists the address and its contents in the specified format. The list mode 
produces a listing similar to that of the machine assembler. Only the print mode is 
available for register display. 

It is often preferable to separate the display commands from the information to be 
displayed. This capability is incorporated in the display package: The operator can in- 
put commands from one unit (e.g. , teletype) and have the display appear on another unit 
(e.g., line printer) . 
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Program Modifications 


The debugging process often involves significant program and data modifications. 
Without a comprehensive debug package the operator is forced either to frequently as- 
semble the source program and reload the resulting object program or to modify the 
machine language. Both alternatives are time consuming and the latter is particularly 
prone to error. By incorporating an on-line assembler, the debug program discussed 
in this report provides a quick turnaround for all program modifications. 

The debug assembler is similar to the machine assembler in that location, instruc- 
tion, and address fields must be specified. The location field is used to specify the 
relative location of the enti-y in the program modification. The instruction field is used 
to specify the instruction mnemonic and for indirect referencing. The address field is 
used to specify the instruction operand if necessary. 

All the machine-instruction mnemonics are available. In addition, pseudo-operation 
mnemonics (pseudo-ops) are available to specify octal entries, scaled or unsealed deci- 
mal integer or floating-point entries, direct-address constants, ASCII information, and 
block storage requirements. 

Address specification has been defined. Special addressing is available to refer- 
ence location-field entries or to postpone address definition. All addresses must be de- 
fined before the program modification input is completed. 

When the operator signals the input to be complete, the program modifications are 
assembled. The machine coding is formed and the required intersector referencing is 
computed from the sector base information supplied during initialization. A source 
listing is then provided for operator verification. The operator may revise the modifi- 
cations or signal their incorporation into this program. 

If the modifications are actually additions to the program, they are placed in the 
program addition area specified during initialization. Linkages between the programs 
and the addition are automatically determined. 

At any time the operator may transfer the modified program from memory to per- 
manent storage (e.g., paper tape). Verification and loading capabilities are incorpor- 
ated. Transfer from one memory location to another, with masking of selected bits, is 
permitted. 


Execution and Analysis 

The debug program provides a method of execution and analysis that minimizes the 
possibility of damage to the program to be debugged and maximizes the execution op- 
tions . The program to be debugged is not executed directly in the debug execution rou- 
tine. Rather, each instruction is lifted from the program, analyzed, and rebuilt for 
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execution inside the routine. All machine registers are S 3 mthesized. The first address 
counter is used as the pseudo program counter, and internal locations are set aside as 
the pseudo instruction register. The registers AREG, BREG, XREG, and KEYS are 
also synthesized as pseudoregisters. With this method of execution, control never 
leaves the debug execution routine. By using instruction analysis combined with the 
execution mode commands, the operator can avoid inadvertent destruction of his pro- 
gram by programming errors. 

When the content of the first address counter is set, the execution routine returns 
the vital statistics of the instruction to be executed: a complete listing of the instruc- 
tion, the contents of the direct address of memory reference instructions, the effective 
address of these instructions (deciphering both indirect chains and indexing), and the 
contents of the pseudoregisters. The operator is advised if the instruction is not exe- 
cutable or if a protected area is about to be violated. 

After the listing, the operator can transfer control to another debug routine to ob- 
tain additional information, to modify his program, or to change the pseudoregisters. 
Alternatively, he can execute his program either on an instruction-to-instruction basis 
or by using one of the following execution modes; 

(1) Execute to the termination address specified by the last address counter 

(2) Execute to a memory- modifying instruction 

(3) Execute to a program-counter-modifying instruction 

(4) Execute until an overflow condition exists 

(5) Any combination of the above 

A permissive memory area may be specified to change the execution termination by 
memory-modifier instructions. Thus, the operator can prohibit data storage outside a 
selected program area. When a terminator is encountered, the described listing is 
produced and the options are again available. 

Although breakpoints are not necessary for execution, they are necessary to termi- 
nate actual execution of the operator's program. These breakpoints are used to trans- 
fer program control from the operator's program to the debug program. Debug com- 
mands are available to insert and delete breakpoints and to transfer control back to the 
operator's program. Control can be transferred from the debug program to the opera- 
tor's program either directly or through a preset initial-condition program. 

A debug routine is used to build on-line and execute subroutines within the debug 
program. These subroutines can be used to supply initial conditions for control trans- 
fers or to structure additional debug routines as desired by the operator. 
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PROGRAM DESCRIPTION 


This section provides background information for understanding debug command 
operation. The debug commands are described in the next section. The various debug 
routines are described in detail in the appendix. 


Command Structure 

The debug program begins with the command structure. Command characters are 
deciphered here, and the appropriate command routine is entered from this structure. 
Most returns, on completion of command execution, and most error returns are made 
to the command struture. The logic is shown in figure 1. The command structure al- 
lows the operator to specify INFORM commands as well as debug commands. The 
INFORM commands are described in reference 1 and are designated by using nonalpha- 
numeric keyboard characters. Debug commands are specified by using control- 
alphanumeric characters. Each command character is assigned a subroutine name. 
When the operator specifies a command character, the corresponding command sub- 
routine is determined and program control is transferred to this subroutine. 

Since all command characters are assigned subroutine names, unwanted commands 
must be satisfied with returns to the command structure when loading the program. 

The operator can therefore tailor an INFORM-debug program to suit a particular need 
during the program-loading process. 

As indicated in figure 1, command operands can be prespecified in terms of a 
name. Prespecified operands are used for INFORM commands only. This feature is 
useful for debug commands, however, in that the INFORM name table may be refer- 
enced by the debug address specification routines. The INFORM names differ from de- 
bug names in that scale factors as well as addresses may be assigned to the names. 
These statistics are assigned in the command structure. Debug name tables are filled 
during execution of a particular command. 


Name Assignments 

The operator can assign names to any memory location. A name can have as many 
as five alphanumeric characters. Each character is packed in truncated ASCII (six 
binary bits per character) into two memory words. Figure 2 illustrates the method 
used. The most significant 2§ characters are packed into the primary name word, and 
the least significant 2§ characters are packed into the secondary name word. Parallel 
tables are used to contain the primary and secondary name words. A third parallel 
table is used to hold the address assignment of the name. 
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Figure 3 illustrates the structure of the name tables for debug names. Because 
multiple sequential tables are allowed for debug names, the operator can assign a list 
of names that correspond to the source listing of each program to be debugged. The 
first location of each primary-name-word table is set to zero to indicate the start of a 
new name list. The first location of each secondary-name-word table is used to specify 
the number of names in the name list. The first location of each address table contains 
the relocation base of the program, which is determined during program loading. 


Address Formats 

Addressing is used to specify operands for the debug commands and to satisfy the 
address requirements of the debug assembler. Several format options are available to 
the operator through address delimiters and postaddress delimiters. 

An address delimiter may be specified instead of a name. Allowable address de- 
limiters are given in table I. Delimiters "APOSTROPHE" and "/" must be directly 
followed by an octal address. Delimiters and "SPACE" allow the first address 
counter to be referenced as an address. Delimiters "$" and ":" may only be used for 
assembler addresses (not for command operands) and must be followed by a decimal 
statement number. With the exception of the "SPACE" delimiter, all address delimi- 
ters require entry of a postaddress delimiter. 

After the initial address is determined, the postaddress delimiter is interrogated. 
These delimiters are given in table II. Delimiters "+" and "-" of table II are used for 
address stringing. An address string consists of an initial address entry followed by 
any number of octal or decimal numbers or the ASCII "B" character separated by the 
"+" or "-" delimiters. Specifying B in the address string causes an external bias 
address (set through an INFORM command) to be inserted in the string. 

The "," delimiter is used to specify assembler address indexing and is prohibited 
for command operands. This delimiter must be directly followed by the "SPACE" 
postaddress delimiter. 

Failure to enter a proper address or postaddress delimiter will cause an error 
message, followed by an error return, to be issued. Failure to specify a name that 
exists in the name table specified in the address initialization routines will also result in 
an error message and an error return. One exception to this occurs if the name is ter- 
minated with the ASCII " delimiter. In this case, the name is assumed to be unique, 
and all debug name tables are searched. If the name is not located, the INFORM name 
table is searched. If it is still not located, an error message and error return are is- 
sued. If the name is found, the name table containing that name is determined and con- 
trol returns to the operator entry point. The operator can then specify a name contained 
in this new name table. In this way, access is allowed to any name in any name table. 
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Debug Assembler 


The debug assembler is used in all debug commands requiring on-line instruction 
coding. The sequenced operation requires source-statement input in a format like that 
used in the regular machine assembler (location, instruction, and address fields). 

When assembly is completed, a source listing is provided for operator verification. 

The location field is five spaces long. It is used to structure the statement entries 
according to decimal statement numbers as well as to define previously undefined ad- 
dresses. Location-field entries are also used to signal completion of source-statement 
entry, to delete statements, and to abort statement entry by a return to the debug com- 
mand structure. Allowable location-field entries are given in table III. Decimal in- 
tegers n are used to specify the location of a source statement within the source- 
statement structure. Thus the operator can easily modify previous statement entries. 
All statement entries must be sequentially numbered, starting with zero. 

Previously undefined address-field entries must be defined before completion of 
source-statement entry is signaled. They are defined by referencing the undefined ad- 
dress $n in the location field. The location-field entry number immediately following 
this reference replaces the undefined address as it occurs in all previous instruction 
entries . 

The maximum source-statement number (limited by the size of the assembler buffer 
to 64) is saved in an instruction counter and used to specify the number of memory loca- 
tions used by the operator's program. This number may be modified by the "M" com- 
mand in the location field. The command is used to specify the completion of a 
source-statement entry, and the "R" command is used to abort the source-statement 
entry. 

After a source-statement number is entered in the location field, the program 
spaces the input device to the instruction field. The instruction field is six spaces long. 
Allowable instruction-field entries are given in table IV. Any machine instruction 
mnemonic or any posudo-op mnemonic given in table V is allowed. Each ASCII charac- 
ter of a mnemonic entry is truncated to five binary bits. The alphabet is thus trans- 
lated into binary numbers ranging from 00001 for A to 11010 for Z. The ASCII num- 
ber characters from 1 to 4 are translated by subtracting octal 226 from the ASCII code. 
These numbers are then binary coded as 11011 to 11110. Since each mnemonic is three 
characters long, it can be represented by a single 16-bit word (see ref. 2 for HDC-601 
instruction mnemonics). 

Indirect addressing is specified by appending the ASCII character to the in- 
struction mnemonic. This character signals the end of the instruction- field entry. If 
indirect addressing is not desired, the ASCII "SPACE" character is used to terminate 
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the mnemonic and to signal the end of the instruction- field entry. The input device is 
then spaced to the address field if an instruction operand is required. 

Assembler addresses are available to reference as yet undefined addresses or 
source-statement numbers. These are "$n" and ":n, " respectively, where n is a 
decimal integer as defined for the location field. 

The pseudo-operations of table V allow the operator to specify data formats and 
direct-address constants and to reserve block-storage locations. Each pseudo-op re- 
quires an address-field entry. Octal integer data can be entered in unsigned 6-digit 
format (negative numbers are represented in two's complement). Decimal data can be 
scaled by terminating the entry with a ASCII "/" character followed by a scale factor 
(see the section Scaling) . An ASCII data entry must be preceded by a decimal number 
that indicates the number of locations it will consume (two characters per location). 
Any locations not filled by the operator will be filled with "SPACE" characters. Indi- 
rect addressing and indexing are allowed. For block storage, the operator specifies 
the decimal number of locations to be reserved. 

When the operator signals completion of source- statement entry "\", the source 
program is assembled. The source program, as well as all intersector reference re- 
quirements, is listed for operator verification. The listing format for memory refer- 
ence instructions is given in figure 4, The listing format for other types of instruc- 
tions and pseudo-operations is similar, with the exception of the address field. If the 
operator is satisfied, the resulting machine-coded object program is transferred from 
the assembler buffer to permanent storage. If the listing is unsatisfactory, the opera- 
tor can either edit the source program or cancel the job, 


Scaling 

The operator can designate scale factors to be assigned to input or output data. 

This feature is available for data display or in conjvinction with any of the assembler's 
decimal pseudo-operations (DEC, FPC, andDPC). Scale factors can be specified by a 
number of means, as given in table VI; Ratios giving the number of engineering units 
per machine unit may be specified directly. A ratio may also be specified to be that en- 
tered for an INFORM name. A scale factor, representing the ratio of voltage to ma- 
chine units of the analog-to-digital converter in the control system, is stored internally 
in the program and can be referenced for any variable. Binary scaling is permitted. 

The ratio of engineering to machine units for binary scaling is 2^/32 768, where nn 
is a decimal number specified by the operator. It is also possible to default the scale 
factor to the last entered value. 


11 


DEBUG COMMANDS 


This section describes the command routines and their use. Eleven commands are 
available in the debug program . The command structure can be modified to add or de- 
lete commands according to need. Command routines are entered by using ASCII con- 
trol characters (represented by underscoring the corresponding alphabet character in 
all tables and figures). Table VII lists the debug command routines, their entry char- 
acters, and their descriptions and references their functional diagrams (given in figs. 

17 to 40). 

Completion of each command routine (except RDEBUG, to be described) returns 
program control to the command structure (fig. 17). This is indicated by the ASCII 

character. In many cases particularly in specifying command operands), opera- 
tor error also causes a return to the command structure. Other errors may simply 
cause a return to the start of the current entry. The operator can intentionally cause 
an error return to the command structure at any time by using the ASCII *'#” charac- 
ter. One other special error character is used in the program: the ASCII "RUB OUT" 
character. This character is used in name specification to cancel previously input 
name characters and to start again. Debug error messages, their descriptions, and 
their consequences are summarized in table VIII. 

Figure 5 presents an assembly-language program to be debugged and illustrates 
the use of each debug command. It is not intended for any purpose other than illustra- 
tion. The figure gives the location in memory of each instruction or data word, the oc- 
tal contents of the location, the name assigned to the location if any, the instruction or 
pseudo-op mnemonic as defined in reference 2, and the address-field reference. The 
purpose of each instruction is stated. The program consists of a main program start- 
ing at Xl and a subroutine starting at Yl. The Xl program has a sector base area 
starting at *■14735. In this area, one intersector reference location is used and two lo- 
cations are available for use. The Yl subroutine is located in a different sector 
('15000) than the Xl program and has no sector base area. The subroutine name YYY 
and its starting location Yl are equivalent and refer to the same location. 

Each command routine is described and illustrated in this section. The sequencing 
steps and options for each command routine are also given in terms of required opera- 
tor entries and terminations. The program’s response, if any, to each entry is indi- 
cated. Certain sequencing steps are common to many of the command routines. These 
steps are used for address specification, scale-factor specification, and on-line assem- 
bly. Sequencing for these operations is given in tables IX, X, and XI, respectively. 
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Initialization Command - YDEBUG 


With the command routine YDEBUG the operator can reserve memory locations to 
contain 

(1) INFORM name and statistics tables 

(2) Debug name and address tables 

(3) On-line program additions 

(4) Debug assembler buffer 

In addition, the operator can protect a memory area from violation during program 
execution when using XDEBUG. This memory area usually is that containing the debug 
program but can be any selected memory area. 

The sequencing and use of this command are given in figure 6. On entry the opera- 
tor must specify the desired area of initialization (INFORM, debug, or protect). Sepa- 
rate entry must be made for each initialization area. 

INFORM initialization requires that the start of its tables (e.g., *16000) and the 
number of names allowed (e.g. , *24) be specified. Since tables must be reserved for 
the primary and secondary name words and the address and scale-factor (two words) 
assignments, the actual number of machine locations reserved for INFORM name speci- 
fication is five times the number of names to be entered plus overhead. After specifi- 
cation, the next available memory location (e.g., '16426) is displayed for the operator. 

Debug initialization requires that the program addition area (e.g., '16426) be spec- 
ified. This area must be contained within a single sector. The assembler buffer must 
immediately follow the program addition area (e.g., '16700). Therefore, specification 
of this buffer's location limits the size of the program addition area. The assembler 
buffer is prespecified to be 64 locations long. Debug name table initialization requires 
that both the first location (e. g. , ' 17000) and the number of names to be entered 
(e.g. , '24) be specified. The actual number of locations reserved for debug names is 
three times the number of names to be entered. After specification, the next available 
memory location (e.g., *17074) is displayed for the operator. 

Protect initialization requires that the initial and final locations of the area to be 
protected (e.g. , ' 15000 '15003) be specified. If these locations are not initialized, 

no area will be protected. 


Source-Name Input Command - UDEBUG 

With the command routine UDEBUG the operator can specify debug source-name 
and address assignments. The sequencing and use of this command are given in fig- 
ure 7 . Names assigned to different programs or subroutines must be specified on sep- 
arate entries into UDEBUG. On entry the operator must specify the relocation base of 
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the program (e.g. , ' 14740 for program XXX and ' 15000 for program YYY). Name and 
address assignments can then be made. In general, names should correspond to the 
names in the operator’s source program, with at least one name being unique to this 
program (e.g. , the program name XXX). This allows a specific name table to be ref- 
erenced when more than one program is being debugged. More than one name can be 
assigned to a location (e.g. , XXX and XI assigned to '14740). All name entries are 
terminated with a space . 

The address entry must be made in octal and preceded by a zero. Any characters, 
except ”W, ” between the name terminator and the start of the address will be ignored. 
Relocatable addresses are terminated by a "SPACE" or a "CARRIAGE RETURN." 
These are stored directly in the address table (e.g., '00 represents location '14740). 
Absolute addresses must be terminated by "A. " The relocation base is subtracted 
from the entry before storage (e.g., '014775A is stored as '35). 

Completion of the name and address entries is signaled by a "W" in the address 
field. Any name may precede this entry. This termination corresponds to the source- 
name-table termination of the HDC-601 assembler listing "0000 WARNING OR ERROR 
FLAGS"). When the name and address assignments are completed, the accumulated 
number of locations used in the primary-name-table area is displayed in octal. This 
includes the initial location of each table used for table statistics. 

At any time before entering a name, the operator may change the input device num- 
ber by starting a line with "; " character. This was not done in the example since all 
names were entered from a single device. The command routine UDEBUG will ignore 
any line beginning with and ending with a "CARRIAGE RETURN." This allows for 
the insertion of comments. 


Sector Base Statistics Command - BDEBUG 

With the command routine BDEBUG the operator can initialize the sector base 
tables used by the debug assembler to form intersector references. The sequencing 
and use of this command are given in figure 8. For each sector used by the programs 
to be debugged, the operator should describe any area used for intersector referencing 
by the loader. This allows the assembler to use existing references and thereby opti- 
mize memory usage. If additional locations adjacent to this area are available for new 
references, this should also be indicated. As a minimum, an area in sector zero 
should be set aside for the creation of intersector references. This sector is used as 
the default sector if no other area is available. 

Ninety-six locations are reserved in BDEBUG to contain the base sector statistics. 
Three locations per sector are used to store the following information; 
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(1) The first location containing an intersector reference (e.g., '14735) 

(2) The first location available for a new reference (e.g., '147 36) 

(3) The last location available for a new reference (e.g., '14737) 

This pernaits sector base tables to be initialized for all sectors contained in a 16K com- 
puter. Initialization must be in octal and be preceded by the octal sector number 
(e.g. , '24). All sector base statistics can be specified on a single entry to BDEBUG. 
Failure to specify for any sector indicates that no sector base area is available in that 
sector. A return to the command structure is made by specifying in place of a 
sector number. 


Display Command - PDEBUG 

With command routine PDEBUG the operator can selectively display the contents of 
the memory or the pseudoregisters. The sequencing and use of this command are given 
in figure 9. For illustration, the names "NL” and "PH” were defined, by using 
INFORM (ref. 1), to have the scale factors 2000 rpm/32 000 machine units and 10 psi/ 
32 000 machine units, respectively. 

On entry the operator specifies the initial (and final if a block) location of memory 
to be displayed or indicates the register to be displayed. He then enters a format num- 
ber to indicate the type of display desired. Allowable format numbers are given in 
table xn. Format numbers 6 and 7 are available for memory display only. The inter- 
pretation of format 7 depends on the display mode selected. Two display modes are 
available: The print mode (selected by terminating the format number with a "SPACE") 
simply displays the contents of the selected cell or cells in the chosen format; the list 
mode (selected by terminating the format number with a "CARRIAGE RETURN") lists 
the selected cell or cells as illustrated in figure 4. 

In the example (fig. 9), pseudoregisters A and B are first printed in octal. This is 
followed by scaled display of each register (initiated by "/") using direct scale-factor 
specification, indirect specification by referencing first "NL" and then "PH, " and 
voltage scale-factor specification "V." Two examples of using binary scaling of the 
pseudo register AREG are then given. Finally, the pseudoregister AREG is displayed in 
double-precision format. This causes the pseudoregisters AREG and BREG to be con- 
sidered as a signed, 30-bit, double-precision integer. The attempt to display the 
pseudoregister BREG in double-precision format is not allowed and produces an error. 
Any double-precision referencing of an odd memory address also produces an error. 

The remainder of the example illustrates memory display using all format numbers 
in the print mode and format number 7 in the list mode. Various t 5 rpes of address spe- 
cification are used for illustration. Location M5 is displayed by first pointing to a 
unique name in program XXX and then the specific name M5 . Once the current table 
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indicator has been set by this process, farther specification of XXX names need not be 
prefixed by a unique name. Also after the first list mode example, the first address 
counter (pseudo program counter) is the same as the last address counter, namely 
X2-1. The next list mode example using first address counter +1 displays location X2. 

An additional feature of PDEBUG is presented in the example. If instead of termi- 
nating a format number with a "SPACE’* or "CAHillAGE RETURN'* an ASCII **=** char- 
acter is specified, the net result of address stringing is printed. 


Modification Command - CDEBUG 

With the command routine CDEBUG the operator can change the contents of mem- 
ory or of any pseudoregister. The sequencing and use of this command are given in 
figure 10. 

On entry, the first and last address counters are specified for memory modifica- 
tions. The first address counter contains the first memory location to be changed. The 
last address counter need not be specified. If it is, it will not limit the number of mem- 
ory locations that can be changed. This limit (64) is set by the length of the assembler 
buffer. However, if a last address is specified and the number of locations changed by 
the operator is less than that indicated by the difference between the last and first ad- 
dress counters, the remaining locations will be filled with the last assembler entry. 

Thus sections of memory can be filled with a constant value. The example illustrates 
scaled-data entry into the five locations reserved for SDAT. Since only four locations 
are entered, the fifth location is loaded with the fourth entry. These changes were in- 
corporated into the program (**Y** response to "GO?**). 

If on entry, a pseudoregister change is specified, more than a single register can 
be modified (note second CDEBUG entry in example). The pseudoregisters are stored 
in the debug program in the following order: AREG, BREG, XREG, and KEYS (in this 
case ' 35622 to ' 35625, respectively). Therefore, if an AREG change is indicated, all 
four registers can be modified by four assembler statements . If a location beyond the 
pseudoregister KEYS will be modified, the operator is advised and the modification 
command is aborted. 

The third entry into CDEBUG illustrates the assembler's handling of intersector 
references. The intersector reference for Yl already existed in the sector base area 
of program Xl. The intersector reference for Y2+1 did not exist and was therefore 
formed by the assembler (note listing of location ' 14736) . These modifications were 
not incorporated into the program ("N" response to "GO?"). The command was abor- 
ted by specifying "R" in the location field. 


16 



Program Addition Command - ADEBUG 

With the command routine ADEBUG the operator can insert additional statements 
into his program. The sequencing and use of this command are given in figure 11. 

Specification of the first address counter indicates the location of the insertion. All 
additions are stored in the program addition area specified during initialization. If the 
original content of the insertion address is to be maintained, it must be included in the 
additions. (In the example listing, a jump through an intersector reference, inserted at 
X2-3 ('14750), is used to link the addition to the program.) The return from the addi- 
tion to the program must be included in the addition by the operator . 


Subroutine Specification and Execution Command - VDEBUG 

The command routine VDEBUG is used for on-line structuring and execution of sub- 
routines. These subroutines can be used for any purpose, including the on-line building 
of additional debug command routines. The sequencing and use of this command are 
given in figure 12. 

On entry the first address counter specifies the location of the subroutine. The op- 
erator must then specify whether a subroutine is to be structured (”I") or executed 
("X") or if a return to the command structure is desired ("R"). After subroutine 
structuring is completed, this specification is again required. 

The usage example illustrates the structuring and execution of a routine to output 
the ASCn data contained in location ADAT to the telet3qDe. The subroutine is placed 
starting at location Y2+1 ('15004). The statement specification illustrates the use of 
statement number (”:'') and undefined address referencing (”$") in the assembler. The 
first location is reserved for the return address (a "BSS" entry results in a "BSZ" re- 
sponse). The return from the subroutine is made in statement 13. Sector 0 is used for 
intersector references. Sector 15 base tables were not initialized in BDEBUG. 

After the operator verifies the listing, he signals transfer of the subroutine to its 
permanent location ("Y" response to "GO?"). He then elects to execute the routine 
("X"). The routine is executed and the characters "AB" printed. The next entry to 
VDEBUG illustrates execution without subroutine structuring. 


Program Execution Command - XDEBUG 

The command routine XDEBUG is used to execute instructions contained in the pro- 
gram to be debugged. The sequencing and use of this command are given in figure 13. 
On entry the first and last address counters are initialized. The first address counter 
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specifies the first location to be executed. The last address counter is an absolute exe- 
cution terminator. Any instruction encountered that violates the area protected in 
YDEBUG will also terminate. 

Other execution terminators are optionally available to the operator. He can ter- 
minate execution when an instruction is encountered that 

(1) Modifies memory outside a specified override area (”M") 

(2) Modifies the program counter (jump and call instructions) ("P”) 

(3) Causes the machine overflow latch to be set ("O") 

These terminators must be set before each execution command. Any combination of 
the preceding can be specified. All terminators are reset whenever execution is ter- 
minated and on entry to XDEBUG. 

Commands are available within XDEBUG to reset the machine overflow latch (•'C") 
and to specify a memory override area (’'A”) used in conjunction with the memory- 
modification terminator. With this override area, a memory- modifying instruction can 
be executed even through the terminator is set, as long as the effective address of the 
instruction falls within the override area. If no override area is desired, a is en- 
tered after the "A" command instead of address specification. 

Two execution modes are available in XDEBUG: 

(1) Single-instruction execution 

(2) Execution to termination 

The example illustrates the use of the terminators and execution modes. The first 
entry to XDEBUG demonstrates the single-instruction execution mode. Execution is 
specified from XI through X2-7. The listing of the first instruction is then provided for 
the operator. It gives the status of the pseudoregisters (AREG = '37200). The KEYS 
are displayed with the four most significant bits in binary and the last six bits in octal. 
The remaining bits of the KEYS are meaningless. After the listing, the operator indi- 
cates single-instruction execution by the "SPACE" character. Execution terminators 
cannot be used in the single-instruction execution mode. The first instruction (CRA - 
clear AREG) is executed and the listing of the next instruction is provided. In this case 
it is a memory reference instruction (STA - store AREG) and therefore the effective ad- 
dress is also displayed (' 14757). Since indexing or indirect referencing is not speci- 
fied in this instruction, the effective address is the same as the direct address. The 
contents of the direct address before execution are also provided in the listing (fig. 4). 
The single-instruction execution mode is continued until a return to the command struc- 
ture is specified ("R"). 

The second entry to XDEBUG illustrates the use of terminators. Initially, sense 
switch 1 is set. Execution from and to statement Xl is specified (i.e., the first and 
last address counters are set to Xl) . After the listing of the first instruction, the oper- 
ator elects execution to the first program-counter modifier ("Pt"). This instruction 
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is encountered at ''14750. The operator then elects to set the memory override area 
to be the single location YHLD. He then specifies execution to the first memory modi- 
fier This instruction is encountered at location "14747. (Incrementing the index 

register modifies location 0.) If he then elects to execute the program without optional 
termination (" t ”) , he encounters a protect violation at "14753, "15001, and "15002. If 
he chooses to ignore these violations, he continues execution until he reaches the loca- 
tion specified by the contents of the last address counter (' 14740). Sense switch 1 is 
then reset so that the instruction in location "14752 (set machine overflow latch) is en- 
countered. Execution to overflow is specified (’*Ot**). Execution is, therefore, ter- 
minated at ' 14752 and the next instruction is listed. The operator next resets the ma- 
chine overflow latch ("C") and continues execution C’l”) until a protect violation is 
about to occur. He then returns to the command structure (”R'’). 


Breakpoint Command - SDEBUG 

With the command routine SDEBUG the operator can insert and delete breakpoints 
in the program to be debugged. Breakpoints identify the occurrence of particular pro- 
gram conditions. The sequencing of this command is given in figure 14. The usage ex- 
ample for this command is discussed in the following section (Return Command - 
RDEBUG). 

The first address counter specifies breakpoint location. The operator then speci- 
fies either "S" to set a breakpoint or ”R'* to restore the original contents of the break- 
point. Five breakpoints can be inserted at any one time. Breakpoint locations and 
their original contents are stored in parallel address and content buffers contained in 
SDEBUG. 

Inserting a breakpoint replaces the program instruction with a call instruction 
made to a reentry location in SDEBUG. The original instruction is saved. The call is 
made by using memory location '20 as an intersector reference. Program control is 
then returned to the command structure. When a breakpoint is encountered and 
SDEBUG is reentered, all priority interrupts are inhibited, the registers are stored in 
their pseudolocations, and the operator is advised of the encounter. 


Return Command - RDEBUG 

The command routine RDEBUG transfers control from the debug program to any 
other program in the machine. The sequencing and use of this command are given in 
figure 15. 
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Returns from the debug program can be made directly or through an initial condi- 
tion program. On entry the operator specifies the return location by setting the first 
address counter and the initial -condition routine by setting the last address counter. If 
the last address counter is not set, no initial-condition routine is executed. The return 
begins when the address-counter specification is completed. 

The usage example illustrates the use of both RDEBUG and SDEBUG. A breakpoint 
is set at location ' 14742. The original content of this location is displayed in octal, and 
control is returned to the command structure. The listing of * 14742 shows the call 
through intersector reference location '20, which replaces the original content. The 
content of '20 ('25504) is the reentry location in SDEBUG. Command routine RDEBUG 
is then entered from the command structure, and a direct return from the debug pro- 
gram is specified. In program Xi the breakpoint at '14742 is encountered and indicated 
to the operator. Control then returns to the command structure. The operator deletes 
the breakpoint by using SDEBUG, and ' 14742 is again listed, showing its original con- 
tents to be restored. Command routine RDEBUG is again entered, and this time an 
initial-condition program is specified to be that subroutine programmed in the VDEBUG 
example. The return location is set to be Xl, A caU to the initial-condition routine is 
made ("AB" printed), and control is transferred to location Xl. 


Transfer Command - TDEBUG 

The command routine TDEBUG transfers the contents of a block of memory to 
another block of memory or to an output device, fills memory from an input device, and 
verifies all input-output transfers. The sequencing and use of this command are given 
in figure 16. 

On entry the address counters are initialized. These counters specify the first 
(e.g., XXX-SDAT) and last (XXX-SDAT+4) addresses of the memory block to be trans- 
ferred or verified. In the example, the first TDEBUG entry illustrates a memory-to- 
memory transfer. After the memory block and transfer type ("M") are specified, the 
first location to receive the transfer is specified ('15040). The transfer mask, which 
is used to delete bits from the transferred memory word, must then be specified 
('177777 for no bit modification). Any bit not set to 1 in the mask is deleted. After 
the transfer mask is specified, the memory transfer is made. The display command is 
then used to verify the transfer. 

The next three entries to TDEBUG demonstrate input-output transfers and verifica- 
tion. In each case the input-output device number must be specified. 
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CONCLUSIONS 


The debug program described herein offers a high level of operator-computer com- 
munication to ease the debugging process of complex assembly-language control pro- 
grams. Information supplied by the computer's assembler and loader and pertinent 
program information supplied by the operator are used to provide communication in an 
easily understandable format. Communication is done through the use of identifiable 
names, flexible addressing, and on-line program, assembly capabilities. 

Eleven debug commands provide the operator with sufficient options to simplify the 
execution, analysis, and modification of his program and reduce program turnaround 
time. The program execution command contains instruction diagnostics to reduce the 
possibility of program destruction by program errors. Displays are available to help 
the operator analyze the program and to advise him of his status within the debug pro- 
gram. Program modifications and additions are easily incorporated on line by an ex- 
tensive debug assembler. The capability to structure subroutines to aid in the debug 
process is also offered. 

Most of the bookkeeping required in the debug process is handled by the debug pro- 
gram. Hard copy of the debug process is easily obtained by using the display routines. 
Flexibility in input-output device selection offers a versatile means of information 
transfer. 

The command structure of the debug program allows the programmer to insert ad- 
ditional debug commands. The program is compatible with the data- analyst s-and- 
display program INFORM. The ability to selectively incorporate INFORM and debug 
eommands allows the structuring of debug and analysis programs that are tailored to 
meet the specific needs of the programmer. 

Lewis Research Center, 

National Aeronautics and Space Administration, 

Cleveland, Ohio, November 20, 1978, 

505-05. 
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appendix - DESCRIPTION OF DEBUG PROGRAM 


Diagrams illustrating the structure of the DEBUG program and the mechanics of its 
various routines are presented in this appendix. Certain parts (particularly the on-line 
assembler) are necessarily peculiar to the HDC-601 computer. Functional statements 
are used throughout so that the program can be easily adapted to other computers. 

The basic input-output routines used for operator command and display are not 
diagrammed since they are generally straightforward and extremely machine dependent. 
Other routines contained in INFORM are also omitted except where necessary to the 
understanding of the debug program . The INFORM routines that are referenced but not 
diagrammed are 

(1) TTYR - general-purpose number input 

(2) TTYR2 - same as TTYR but with the first character prespecified by the pro- 

gram 

(3) INPT - character input 

(4) LOAD - general-purpose loader 

(5) VERIFY - general-purpose verifier 

(6) PUNCH - general-purpose binary dump routine 

(7) C$24 - floating-point to double-precision integer conversion 
These routines are described in reference 1. 

The nomenclature used in the diagrams is as follows: 

(1) Subroutine names are given in parentheses (e.g., (NAME)) 

(2) Location names are given in brackets (e.g. , [CSUB]) 

(3) ASCII characters are given in quotation marks (e.g., "A") 

(4) ASCII control characters are understored (e.g., 

The functional statements are boxed. If more than one result can occur from execution 
of a statement, the results are indicated on linkage lines emanating from the statement 
box. All program messages are omitted from the functional diagrams for simplicity. 

The command structure, given in figure 17, shows the debug command subroutines. 
Some of the INFORM command subroutines are also shown. See reference 1 for a com- 
plete description of INFORM's capabilities. Figures 18 to 28 are functional diagrams 
of the debug command subroutines. These routines are straightforward and are dis- 
cussed in detail in the main body of this report. Appendix figures 29 to 39 are function- 
al diagrams of utility routines required to support many of the debug command sub- 
routines . 

Figure 29 illustrates the structure of the on-line assembler. It consists of three 
parts: 

(1) PTCH is used for location-field entries, to input assembler commands, and to 
sequence assembler events. 
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(2) CMDI is used for instruction- and address-field entries, 

(3) ASEM is used to form the machine coding (object program) corresponding to the 
source-field entries. 

These assembler routines require the support of additional subroutines: LIST (fig. 30), 
FNDI (fig. 31), FNDM (fig. 31), GSFR (fig. 32), SBSE (fig. 33), and TRAN (fig. 34). 

In CMDI, two special buffers (with 64 locations each) hold the instruction- and 
address-field entries . If the instruction is a memory-reference instruction, the in- 
struction op-code is stored in the instruction buffer and the positive address is stored 
in the address buffer. If the address is a location- field number, the second least sig- 
nificant bit (bit 15) of the instruction word is set. If the address is undefined, the least 
significant bit (bit 16) is set. Shift instructions have the op-code stored in the instruc- 
tion buffer and the negative shift count stored in the address buffer. This number is al- 
ways greater than '177700 (-64). All other machine instructions and pseudo-op oper- 
ands are self-contained within the instruction word. Special codes are used to distin- 
guish these instructions for the assembler and listing programs. These codes are given 
in table XIII. 

Subroutine FNDI contains the instruction mnemonic words and their corresponding 
op-codes in parallel tables. This routine is used to obtain op-codes from mnemonic 
specification by CMDI. This routine also returns the instruction type (memory refer- 
ence, shift, etc.) for address-field determinations . 

Subroutine FNDM is the inverse of FNDI. A mnemonic is returned that corre- 
sponds to a specified instruction. The instruction t5q>e is indicated. This routine is 
used in the source listing procedure. 

When the operator signals completion of source-statement entry, control is trans- 
ferred to subroutine ASEM for assembly. The address buffer is interrogated to deter- 
mine the instruction type. If it is a shift instruction (-64< ADDRESSED), the shift count 
is combined with the op-code and stored in the corresponding assembler buffer location. 
If it is a memory-reference instruction (0 ADDRESS), intersector referencing is com- 
puted by using SBSE and sector base statistics supplied by BDEBUG and modified by 
TRAN. If external indirect reference generation is required, the instruction counter is 
incremented and the external address is added to the end of the instruction buffer. The 
original address is appended by the indirect and index modifier bits as set in the origi- 
nal instruction word and stored in the corresponding assembler buffer location. Ad- 
dress code 8 (table XIII) is stored in the corresponding address buffer location for in- 
terrogation by the transfer routine TRAN. The original address buffer location is mod- 
ified to contain the external address. The index modifier bit of the original instruction 
word is reset, and the indirect modifier bit is set. The instruction is then reassembled. 
Memory reference instructions not requiring intersector referencing are combined with 
the corresponding address buffer word and stored in the assembler buffer. 
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When assembly is completed, PTCH lists the source program by using the LIST 
subroutine, as well as listing all intersector reference requirements for operator veri- 
fication, Verification is indicated in TRAN. If the operator is satisfied, he signals for 
program transfer from the assembler buffer to permanent storage. Routine TRAN does 
the transfer and also modifies external addresses (CODS) as required for intersector 
referencing. TRAN modifies the sector base statistics (see section Sector Base Sta- 
tistics Command - BDEBUG) to reflect the addition of intersector references. 

With the scaling routine GSFR the operator can designate scale factors to be as- 
signed to input or output data. This routine is used for assembler decimal data entry 
and also in the PDEBUG command routine. 

Figures 35 to 40 illustrate the debug address and name specification and handling 
routines. Addressing is used to specify operands for the debug commands and to sat- 
isfy the address requirements of the debug assembler. 

Subroutine CMMP (fig. 35) is used for command operand specification. It initial- 
izes the first and last address counters with addresses obtained through GETN (de- 
scribed below) . If only a single operand is specified, the address counters are set the 
same. Operator errors leave the address counters unaffected, and an error return 
from CMMP is made. Correct operand specification causes the current prograip indi- 
cator to be computed through CSET (fig. 36). 

In subroutine CSET, the contents of the first address counter are compared with 
the relocation base of the various address tables. The maximum base value that is less 
than the contents of the first address counter is determined, and the address of the cor- 
responding primary-name table is stored in a location reserved for the current pro- 
gram indicator. 

Subroutines GETN and ADRS (fig. 37) initialize the address specification subroutine 
GETA. Subroutine GETN specifies the debug name table; subroutine ADRS specifies 
the INFORM name table and prohibits address indexing and the special assembler ad- 
dress formats. Subroutine CMCK (fig. 37) flags special assembler address formats as 
errors when warranted. 

Subroutine GETA (fig. 38) is a general-purpose operator address specification rou- 
tine. It is used for all addressing in both INFORM and the debug program. Initializa- 
tion and entry must be made through GETN or ADRS. Certain implicit initializations 
are also required. The operator is allowed to reference a special external-bias ad- 
dress set through an INFORM command. Referencing of this address is allowed only 
after the address stringir^ delimiters (see below). The first address counter is used 
by address displacement delimiters (see below) as the referaice address. It is gener- 
ally set when specifying command operands in CMMP but may also be set in the 
ADEBUG, PDEBUG, and XDEBUG command routines (see the section DEBUG 
COMMANDS). 
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On entry to GETA, a versatile address input format is available to the operator 
through the use of address delimiters and postaddress delimiters . The NAME subrou- 
tine (fig. 39) specifies either a name or an address delimiter. If a name is entered, 
the name table specified by GETN or ADRS is searched. If the name is found, the cor- 
responding address is determined. The termination character of the name entry speci- 
fies the postaddress delimiter. 

Subroutine NAME is used for operator name specification. The primary and sec- 
ondary name words are formed and made common to other routines. Any character 
other than an alphanumeric, a delimiter, will terminate the name entry. The termi- 
nating character is tested to insure proper name entry in the calling routines. If no 
name is entered, the name words are filled with "SPACE” characters, and the delimi- 
ter entered is treated as a command by the calling routines. This subroutine is used 
to input most INFORM and debug names. 

Subroutine NFIN (fig. 40) locates a name assigned to a specified address. All 
name tables are searched. If the address is located, the corresponding name words 
are returned. If the address cannot be located, NFIN returns name words filled with 
"SPACE" characters. 

Subroutine FIND (fig. 40) obtains the displacement of a specified name from the 
start of a name table . On entry the table to be searched and the displacement between 
the primary and secondary name tables must be specified (since FIND can interrogate 
INFORM tables also). An error exit is used if the name cannot be found. The dis- 
placement is used by the calling routine to determine the address assigned to the name. 
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TABLE I. - ALLOWABLE ADDRESS DELIMITERS 


Address 

delimiter 

Description 

APOSTROPHE 

Indicates that absolute octal entry follows 

♦ 

Specifies first address counter as entry 

/ 

Indicates that relative octal entry follows 

SPACE 

Specifies first address counter plus 1 as entry 

$ 

Indicates that an undefined assembler address follows 


Indicates that a defined assembler address follows 


TABLE II. - ALLOWABLE POSTADDRESS DELIMITERS 


Postaddress 

delimiter 

Description 

+ 

» 

SPACE 

Indicates address addition 
Indicates address subtraction 

Assembler address indexing (must be followed by SPACE) 
Signals completion of address entry 
Specifies a unique name 


TABLE m. - ALLOWABLE ASSEMBLER LOCATION- FIELD 

ENTRIES 


Location- 

field 

entry 

Description 

Q 

Indicates location of following instruction in operators 


program (n = decimal integer, 0 :S n 63) 

$n 

Indicates that following location defines undefined 


address, $n (n = decimal integer, 0 n s 63) 

\ 

Indicates completion of operator's instruction entries 

M 

Allows operator to view and modify the location counter 

R 

Returns to INFORM/debug command structure 





TABLE VI. - ALLOWABLE SCALE- FACTOR ENTRIES 


Sc ale -factor 

Description 

entry 


E.U./M.U. 

Directly specifies ratio of engineering unit (E.U.) to 
machine unit (M.U.) 

NAME 

Specifies scale factor assigned to a name in INFORM 
table 

V 

Specifies voltage scaling (10 volts/32 000 M. U. ) 


Defaults to last entered scale factor 

B(im) 

Specifies binary scaling, where (nn) represents any 
+ or - integer. (2*^^ E. U. /32 768 M. U. ) 


TABLE V. - ALLOWABLE PSEUDO-OPERATION 
MNEMONICS 


Mnemonic 

Address-field entry 

OCT 

Octal integer data 

DEC 

Decimal integer data 

FPC 

Decimal floating-point data 

BCI 

ASCII data 

DPC 

Decimal double-precision integer data 

DAC 

Direct-address constant 

BSS 

Block-storage reservation 

BSZ 

Block-zero storage reservation 


TABLE IV. - ALLOWABLE ASSEMBLER INSTRUCTION- FIELD ENTRIES 


Instruction- 

field 

entry 

Description 

APOSTROPHE 

Indicates entry of an instruction or datum coded in octal 
(The OCT pseudo-operation may also be used for 
octal data entry.) 

XXX 

Instruction mnemonic (where XXX is any machine in- 
struction mnemonic) 

YYY 

Pseudo-operation mnemonic (where YYY is any pseudo- 
operation defined in table VIII) 

* 

Specifies indirect addressing (also signals completion of 
instruction-field entry) 

SPACE 

Signals completion of instruction-field entry 




TABLE Vn. - DEBUG COMMAND ROUTINES 


Routine 

Entry 

Figure 

Description 


command^ 



YDEBUG 

Y 

18 

Initializes debug and INFORM programs 

UDEBUG 

U 

19 

Assigns debug source names and addresses 

BDEBUG 

B 

20 

Initializes sector base statistics 

PDEBUG 

P 

21 

Displays memory or register 

C DEBUG 

C 

22 

Modifies program or pseudoregister 

ADEBUG 

A 

23 

Inserts additional statements into program 

VDEBUG 

V 

24 

Specifies and executes subroutine 

XDEBUG 

X 

25 

Executes program 

SDEBUG 

s 

26 

Inserts or deletes breakpoint 

RDEBUG 

R 

27 

Returns to program 

TDEBUG 

T 

28 

Transfers memory from block to block 


^Underscoring denotes ASCII control character. 


TABLE Vni. - DEBUG ERROR MESSAGES 


Error message 

Meaning 

Program control transfer 

? 

Nonrecoverable error 

Command structure 

X? 

Execution command error 

XDEBUG command input and decoder 

NOT EX 

Nonexecutable instruction encountered 

Command structure 

CSET 

in XDEBUG 

Last instruction executed in XDEBUG 

None 


PV 

caused overflow latch to be set 
Execution of following instniction 

None 


OVFLON 

will cause protect violation 
Overflow of debug name tables using 

Command structure 

OVFLOP 

UDEBUG 

Overflow of program addition area 

Debug assembler's reentry location 

FORMAT 
NO $ REF 

$n 

OVFLOM 

OVFLOB 

using ADEBUG 
Assembler format error 
Operator tried to define a nonexistent 
undefined address reference 
Operator failed to define undefined 
address reference $n 
Overflow of assembler's buffer or 
instrument buffer (64 locations) 

No inter sector reference locations 

None 


SPOF 

are available 

Single-precision overflow 

Command structure 

$N 

Name specification error 

Start of NAME 


OVFLOA 

Specified address is negative 

Command structure 

IDR>32 

Indefinite indirect chain encoun- 

None 


S? 

tered in XDEBUG 
SDEBUG error 

Command structure 



TABLE LX. - SEQUENCING FOR ADDRESS- FIELD SPECIFICATION 


Step 

Enter 

Terminate 

Response 

Go to step 

Description 

la 

(Name) 


None 

1 

Temporarily specifies name table that 






contains entry 

lb 

(Name) 

None 



2 

Specifies name in specified name table 

Ic 

(Octal) 







Specifies absolute octal address 

Id 

/Petal) 







Specifies relative octal address 

le 

* 







Specifies first address counter as 









address 

If 

SPACE 







Specifies first address counter plus 1 









as address 

2a 

SPACE 





Exit 

Terminates address entry; returns to 








calling program 

2b 

+ 





1 

Indicates address addition 

2c 

- 





1 

Indicates address subtraction 

2d 

» 



1 

3 

Specifies address indexing 

3 

SPACE 



None 

Exit 

Terminates address entry; returns to 







calling program 


TABLE X. - SEQUENCING FOR SCALE- FACTOR SPECIFICATION 


Step 

Enter 

Terminate 

Response 

Go to step 

Description 

— 



SF= 

1 

Advises operator of scale-factor entry 







requirement 

la 

(Decimal) 

SPACE 

/ 


2 

Specifies engineering units (numerator) 

lb 

* 

None 

None 

Exit 

Specifies last scale-factor entry as 







scale factor 

ic 

V 

None 



Exit 

Specifies 10 volts /32 000 machine units 







as scale factor 

Id 


None 



3 

Indicates use of INFORM name for spe- 







cification 

le 

Bnn 

SPACE 



Exit 

l^ecifies 2™/32 768 as scale factor 

2 

(Decimal) 

SPACE 



Exit 

Specifies machine units (denominator) 

3 

(Name) 

SPACE 



Exit 

Uses scale factor specified for 







INFORM name 
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TABLE XI. - SEQUENCING FOR ON-LINE ASSEMBLER 


Step 

Enter 

Terminate 

Response 

Go to step 

Description 

la 

R 


None 

None 

Return 

Terminates command and return to command 








structure 

lb 

\ 


None 

Listing 

Exit 

Indicates end of entries. Returns to calling 








program 

ic 

M 


None 

Output 

2 

Advises operator of location count and per- 








mit change 

Id 

(Decimal) 

SPACE 

Spaces 

3 

Specifies location-field entry number 

le 

$ (Decimal) 

SPACE 

CRLF 

1 

Specifies undefined address definition 

2a 

> 


None 





Indicates no change in location count 

2b 

(Decimal) 

SPACE 





Specifies location count 

3a 

(Octal) 

SPACE 





Octal data and instruction entry 

3b 

(Mnemonic) 

SPACE 

Spaces 

4 

Mnemonic entry requiring address 

3c 



* 

Spaces 

4 

Mnemonic entry requiring indirect address 

3d 



SPACE 

Spaces 

5 

Mnemonic entry requiring operand 

3e 



SPACE 

CRLF 

1 

Mnemonic entry not requiring address or 








operand 

4a 

Address 

SPACE 

CRLF 



Specifies address 

4b 

Address 

9 

1 CRLF 



Specifies address with Indexing 

4c 

(Decimal) 

SPACE 

CRLF 



Specifies location number as address 

4d 

(Decimal) 

I 

1 CRLF 



Specifies location number as address with 









indexing 

4e 

$ (Decimal) 

SPACE 

CRLF 



Specifies undefined address 

4f 

$ (Decimal) 

1 

1 CRLF 



Specifies undefined address with indexing 

5a 

(Number) 

SPACE 

CRLF 



Specifies operand 

5b 

(Number) 

/ 

SF 

= 



Specifies sealed operand (used with decimal- 









entry pseudo-operations only) 


TABLE Xn. - FORMAT NUMBERS FOR DISPLAY COMMAND 


Format 

number 


0 

1 

2 

3 

4 

5 

^6 

/ 


Display type 


Six-digit octal 
Decimal integer 
Decimal floating point 
ASCn 

Double-precision decimal integer 
Direct-address constant 

Block storage (displays number of successive zero locations) 
Effective-address contents (print mode) 

Machine instruction (list mode) 

Scaled floating-point decimal (see section Scaling and table X) 


^Available for memory display only. 
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TABLE Xin. - ASSEMBLER ADDRESS- FIELD CODING 


Ccxie 

Octal 

value 

Description 

0 

177000 

Specifies octal integer data 

1 

177001 

Specifies decimal integer data 

2 

177002 

Specified decimal floating-point data 

3 

177003 

Specified ASCII data 

4 

177004 

Specifies double-precision integer data 

5 

177005 

Specifies direct- address constant 

6 

177006 

Specifies block-storage reservation 

7 

177007 

Specifies nonmemory reference instructions 

8 

177010 

Specifies external address constants required 
by assembler for intersector referencing 





Figure 1. - Functional diagram of command structure. 


PRIMARY NAME WORD 


SFi.ONTiARY NAMf WURD 



NOT 

USED 


Figure 2. - Character packing for name words. 












PRIMARY NAME SECONDARY NAME 

WORD TABLE WORD TABLE 


ADDRESS 

TABLE 


000000 
IS). NAME 


LASf NAME 
000000 
iS\ . NAME 


LAHr NAME 

000000 
Uil NAME 


LABI NAME 


NUMBER OF NAMES 
1ST. NAME 


LAST NAME 
NUMBER OF NAMES 
1ST. NAME 


LAST NAME 


NUMBER OF NAMES 
1ST. NAME 


LAST NAME • 


' RELOCATION BASE 
1ST. ADDRESS 


LAST ADDRESS 
RELOCATION BASE 
1ST. ADDRESS 


LAST ADDRESS 


RELOCATION BASE 
1ST. ADDRESS 


LAST ADDRESS 


Cm, irp ^ - Format of debug name and address tables. 


FIRST 

SUBROUTINE 

OF 

PROGRAM 
TO BE 
DEBUGGED 


SECOND 

SUBROUTINE 


LAST 

SUBROUTINE 


LULAIUjN UI INBTRUCriUN < OCIAl ') 

_ NAMb ABBiGNbD 10 LflCATTON 

-ItlCAIION CONTENTS ( OCTAL ) 

-INSTRUCTION MNEUMONXC 

FOR INDTRtCTi- "SPACE' IF NOT. 
^ ADIiRESS REFCKENCE < OCIAL ) 


FOR TNDEXINGr ’SPACF* IF NOT. 

-NAME ASSIGNED TD ADDRESS 

ADDRESS CONTENTS < OCTAL ) 


I t)i ATTON 
V 11- 1 D 


; 

I Cl Cl r 


MMM( I > 
s/ 


AAAAAtX> 


INSTRUCTION 
FIE» D 


ANAMT ACACAC 


address 

FTH D 


Figure 4. - Source listing format for memory reference instructions. 
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Octal 

Lxation 

Lxation 

Instruction 

Address 

Ixation contents 

name 

field 

field 

14735 

025000 




14736 

000000 




14737 

000000 




14740 

140040 

XI 

CRA 


14741 

011757 


STA 

YHLD 

14742 

073760 


LDX 

M5 

14743 

105761 


LDA* 

YDAC 

14744 

023757 


CAS 

YHLD 

14745 

011757 


STA 

YHLD 

14746 

101000 


NOP 


14747 

024000 


IRS 

0 

14750 

003743 


JMP 

•-5 

14751 

101020 


SSI 


14752 

140600 


SCO 


14753 

121735 

X2 

CALL 

YYY 

14754 

014757 


DAC 

YHLD 

14755 

154776 


DAC* 

YHLD, 1 

14756 

003740 


JMP 

XI 

14757 

000000 

YHLD 

BSZ 

1 

14760 

177773 

M5 

DEC 

-5 

14761 

054775 

YDAC 

DAC 

EDAT, 1 

14762 

140702 

A DAT 

BCI 

2, ABC 

14763 

141540 




14764 

037346 

FDAT 

DEC 

0.1 

14765 

063146 




14756 

000000 

DDAT 

DPC 

4 V 

14767 

000004 




14770 

000000 

SDAT 

BSZ 

5 

14771 

000000 




14772 

000000 




14773 

000000 




14774 

000000 




14775 

177777 

EDAT 

OCT 

177777 

14776 

000000 

XHLD 

BSZ 

1 

15000 

000000 

VI 

BSZ 

1 

15001 

025000 


IRS 

Y1 

15002 

025000 


IRS 

Y1 

15003 

103000 

Y2 

JMP* 

Y1 


Comments 

1st location used for intersector reference 
1st location available for infersector reference 
Last location available for intersector reference 
Program start. Clear A register. 

Store A register in 14757 

Load X register with -5 

Load A register indirect from 14761 

Compare A register to YHLD 

Here if > YHLD, store A register in YHLD 

Here if = YHLD, no operation 

Here if < YHLD, increment X register. Skip if zero 

Jump to 14743 

Skip if sense switch 1 set 

Set overflow latch 

Cali program YYY through indirect reference 
Direct address constant 
Direct address constant, indexed, indirect 
Jump to 14740 

One location reserved for YHLD 
Decimal integer 

Direct address constant, indexed 
ASCII data 

Floating point 

Double precision 

Five locations reserved for SDAT 


Octal integer 

One location reserved for XHLD 

Start of program YYY 
Increment Y1 (return address) 
Again 

Return to calling program 


Figure 5. - Example program for debug illustrations. 



step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 


i 

— 



Y: IDP? 

2 

Enters YDEBUG from command structure 

2a 


i 

— 

— 

START' 

3 

Indicates INFORM initialization 

2b 


D 

— 


PATCH' 

5 

Indicates debug initialization 

2c 


p 

— 


X 

9 

Indicates protect-area initialization 

3 

Octal 

SPACE 

NUMBER' 

4 

Specifies start address of INFORM name tables 

4 





Display 

Return 

Specifies maximum number of INFORM names 

5 





ASMBL' 

6 

Specifies start address of program addition area 

6 





NTABL' 

7 

Specifies start address of assembler buffer 

7a 





NUMBER ' 

3 

Specifies start address of debug name tables 

7b 



— 

— 


Return 

Defaults debug name table statistics 

8 

Octal 

SPACE 

Display 

Return 

Specifies maximum number of debug names 

9a 

Octal 

SPACE 

- 

10 

Specifies first location of protect area 

9b 



- 

- 


Return 

Specifies no area to be protected 

10 

Octal 

SPACE 


Return 

Specifies last location of protect area 


(a) Sequencing. 


«“Y: IDP7 I 
START: •1,6000 
NUMBR: *24 
*016426 
♦-Y: IDP7 D 
Patch: *16426 

ASMbL: *16700 
NTABL: *17000 
NUMBR: *24 
*017074 

•-Y; IDP7 PP= *15000 *-*15003 


(b) Example. 

Figure 6. - Sequencing and use of YDEBUG command routine. 


Step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 

U 


U BASE' 

2 

Enters UDEBUG from command structure. 

2 

Octal 

CARRIAGE RETURN 


3 

Specifies relocation base for source-name entries 

3a 

Name 

SPACE 


4 

Specifies a source name 

3b 





6 

Indicates change of input device 

3c 

•Comment 

CARRIAGE RETURN 


3 

Allows program to ignore comment lines 

4a 

W 


Display 

Return 

Terminates current program source-name entry 

4b 

Zero 




5 

Indicates address entry 

5a 

Octa 


CARRIAGE RETURN 


3 

Specifies relative address of source name 

5b 



SPACE 




Specifies relative address of source name 

5c 



A 




Specifies absolute address of source name 

6 



CARRIAGE RETURN 




Specifies input device number 


(a) Sequencing. 

*-U: BASE: *14740 

XXX 00 
XI 00 
X2 013 
YHLD 017 
M5 020 
YDAC 021 
ADAT 022 
FDAT 024 
DDAT 026 
SDAT 030 
EDAT 014775A 
XKLD 036 
0000 W 
*000015 

*-U: BASE:*15000 

YYY 00 
Y1 00 
Y2 03 
0000 w 
*000021 


(b) Example, 

Figure 7. - Sequencing and use of UDEBUG command routine. 




step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 

B 


B; 

2 

Enters BDEBUG from command structure 

2a 

R 


— 

Return 

Terminates entries 

2b 

Octal 

SPACE 

— 

3 

Specifies sector number 

3a 

R 


— 

Return 

Terminates entries 

3b 

Octal 

SPACE 

— 

4 

Specifies first location used for intersector reference 

4a 

R 


— 

Return 

Terminates entries 

4b 

Octal 

SPACE 

— 

5 

Specifies first location available for intersector reference 

5a 

R 


— 

Return 

Terminates entries 

5b 

Octal 

SPACE 

— 

2 

Specifies last location available for intersector reference 


(a) Sequencing. 


«-a: 

*0 '6U0 '60C *7nc 

•l^ *14735 ‘M73S 'U737 

*,•1 

(b) Example. 

Figure 8. - Sequencing and use of BDEBUG command routine. 


Step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 

P 


P: 

2 


Enters PDEBUG from command structure 

2a 

<A 


), 

5 


Specifies display of pseudo A register 

2b 

(B 


), 



Specifies display of pseudo B register 

2c 

(X 


), 



Specifies display of pseudo X register 

2d 

(K 


). 



Specifies display of pseudo K register 

2e 

Address^ 

SPACE 


3 


Specifies first address of memory to be displayed 

3a 

SPACE 


, 

5 


Indicates single display 

3b 

♦- 



4 


Indicates multiple display 

4 

Address® 

SPACE 


5 


Specifies last address of memory to be displayed 

5 

Decimal'’ 

SPACE 


6 


Specifies dispiay format 

6a 

SPACE 


Display 

Return 

Displays specified entry in print mode 

6b 

CARRIAGE 


Display 

Return 

Displays specified entry in list mode 


RETURN'’ 






6c 



Display 

Return 

Displays memory address 


®See table IX. 

'’See tables X and XII. 

‘-Not allowed for register display. 


(a) Sequencing. 

MCO :;F: 1/1'> 

-Fh,A: *l:.l i;F= 

-P: (A),0 r ( 

»'P; (^),C : 

•'?i (A),/ LF: ju ; 1 'u'.'C ('( 

•“P: CA),/ aF: *-‘;L = 

-P: (A) ,/ SF: -Pm 5 51. .u : -,.s 

-P: (A) , / _F: V = 5i I f ' -J X. 

-Ps (A),/ IF: . 15 : Cl 

-P; ( A) ,/ : ..A : ?'• 1 

in) z cf . . a , 2 :.i ^ ; 

-r: : ? 

‘ . ,5 ,1 

U7^,. : -(M'Lw-' 

1A7'S.. = A.- 

-} : - — -1 ,7- 

1^7t,^ : Ai- 

U7S5 : C 

-f: /' . ,- 

1-i7'm‘. : .liTi :’it 

-P: 

!A7t 5 : >« 1477r , 1 ' . 1_, ( 'M x\.(. 

-P: * ,7 

i‘ “ ‘ ’ 5 

- P : ;,1 -...-I , 


1 .7 
U7a 1 


1-. ■ ■ ,v 


1-1?-..- 

U7-‘, 


1 V /- ! ' 1 -.7 1 7. 

. 7. 7 c.. 17.7 Y 

1 175 7 1-7 7 \L- 

t ^775 

V 1 t ' 

1 . 7/1 7 
1- 

1 ‘1 7> ! 


1 1 ■ ■ ■ T 

' 1 I f 

. t I-.?-: 

M.K . ( ( 

1CS7M 

14 75'. 

*-!' : , ' 

1^75,7 

-r: 


l-M . .-C. 

1 Ai.y. . ■ ' 1 -7:5 

: : - ' ! , : r. ^ ■ 

' GO 



(b) Example. 



Figure 9. - Sequencing and use of PDEBUG command routine. 


of number densities shown, the floating potential profiles were probably geometrically 
similar over this range. 

Figure 29 shows similar data for the same electrode but with negative polarity. Be- 
cause both the ion saturation current and the electrode current were linearly proportional 
to the average electron number density, the density profiles were probably geometrically 
similar over the range of number densities shown. The particle confinement time was 
almost independent of average number density over more than a factor-of-50 variation in 
these quantities, and the floating potential varied relatively little over the same range. 
The radial profiles of the floating potential were probably geometrically similar over the 
range of number densities shown. 



Rgure 29. - Parametric variation of particle confinement time, floating potential, electrode cur- 
rent, and ion saturation voltage (relative ion number density) as functions of average electron 
number density - run series AJU (table IV). 
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step 

Enter 

Terminate 

Response 

Go to step- Description ’ 

1 

2 

3 

4a 

4b 

A 

Address® 

Source® 

Y 

l\l 

SPACE 

A; 

Listing 

2 Enters ADEBUG from command structure 

3 Specifies address of program addition 

4 Enters assembler for addition specification 

Return Inserts addition into program 

3 Reenters assembler for changes 


^See table IX 
‘’See table XI. 


(a) Sequencing. 

«-A; X2-.^ 

0 L: A YYY.Yl 

1 STA YYY.Y.'tI tc.’tl 

2 J'w" n+3 f'C'f t.'; 

\ 


164 26 

U->43 1 

L./A- 

1643 1 


o: ; - 1.‘ 

16427 

1 1 H3^ 

OThx 

1 6^3 2 


K 57 -7 

16430 

1o3a33 

J•;^x 

I6a33 


1 ' 7 7 7 

16431 

0I5uU(- 


15iro 

YYY 

C/..C V V ■ 

16432 

015 uui, 

uAO 

15UC4 


11171, 

16433 

014743 

jAC 

1 4743 


IC57M 

14750 

736 


14736 


Cl L.CCl 

14736 
GO? N 
R 

016426 

..AC 

164 26 


oLcroi 


(b) Example. 

Figure 11. - Sequencing and use of ADEBUG command routine. 



step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 

V 


V;IXR? 

2 

Enters VDEBUG from command structure 

2 

Address** 

SPACE 


3 

Specifies subroutine address 

3a 

I 



4 

Specifies that subroutine is to be programmed 

3b 

X 



Return 

Specifies that subroutine is to be executed 

3c 

R 



Return 

Specifies return to command structure 

4 

Source“ 

\ 

Listing 

5 

Enters assembier for subroutine specification 

5a 

Y 



3 

Transfers subroutine to specified iocation 

5b 

N 



4 

Reenters assembler for changes 


^See table IX. 
°See table XI. 


(a) Sequencing. 

*-Vj YYY.Y2+1 
IXil? 1 


0 

BBS 

1 

00000 

1 

LDX 

II 

00001 

2 

LDA 

XXX.AOAT Oi: 

S 

IA3 


00003 

A 

CRA 


00004 

5 

LLL 

8 

UC0(r5 

6 

SKS 

•104 

00005 

7 

JMP 

;6 

OOOC7 

8 

XP 

'1C4 

0G0C8 

9 

UTA 


0U009 

10 

Ji-lP 

:8 

OOOIC 

1 1 

I.-IS 

•0 

cool 1 

12 

jr.P 

:4 

000 1 2 

13 

SI 


:C 

00013 

\A 

\ 

DiC 

-2 

coo 14 


15004 

OOOOOO 

bSZ 

COCCI 



15005 

073022 

LDX 

15022 


121726 

15 006 

10460C 

L JA* 

00600 


ocoocc 

15007 

C 0020 I 

lAu 




15 010 

1 40('4(5 

C.IA 




1501 1 

041070 

LLL 

CL 



15012 

070104 

3K8 

ni U4 



15013 

01-3012 

jrip 

15L12 


C('5C12 

15014 

030104 

OCP 

0104 



15015 

17C004 

OTA 

0C04 



15016 

003C14 

JI')P 

15014 


1C3725 

15017 

024000 

I riS 

nooc'O 


OGOUUO 

15020 

003010 

jy.y 

15011' 


121722 

15021 

103004 

J IF* 

15 004 


111716 

15022 

1 77776 

jlc 

-onoc2 


! 40702 

00600 

014762 

jAC 

14762 

AjAi 


fliJ? Y 
ixrt? r.Ao 
«-V: Y2+1 
l'An7 XAj 

(b) Example. 

Figure 12. - Sequencing and use of VDEBUG command routine. 



Step 

Enter 

1 

X 

2 

Address'' 

3a 

SPACE 

3b 


4 

Address® 

5a 

C 

5b 

M 

5c 

P 

5d 

0 

5e 

A 

5f 

t 

5g 

SPACE 

5h 

R 

6a 

Address® 

6b 

- 

7a 

SPACE 

7b 

- 

8 

Address® 


Terminate 


Response 


X: 

SPACE 

Listing 

SPACE Listing 


Listing 

Listing 


SPACE 


SPACE 


^See table IX. 


Go to step- 

Description 

1 

? 

Enters X DEBUG from command structure 

3 

Specifies first address to be executed 

5 

Sets execution stop address to first address 

4 

Indicates stop address to be specified 

( 

> 

Specifies execution stop address 

Clears overflow latch (bit 1 of pseudo K register) 

Sets memory modifier terminator 

Sets program counter modifier terminator 

Sets overflow terminator 



Indicates memory-modifier termination to be qualified 

C 


Executes to stop address or as indicated by terminators 

C 


Executes single Instruction (terminators not applicable) 

Return 

Returns to command structure 

7 


Specifies first address that can be modified 

5 


Specifies memory-modifier termination not qualified 

5 


Indicates that only single Ixation can be modified 

8 

Indicates that memory area can be modified 

L. ^ 


Specifies last address in area that can be modified 


(a) Sequencing. 


-X: XXX. XI -XXX. X2-7 


OZT'dCOA 
iAi4(. X'/:. 

CUSEUOd 
y 140040 

177773X 

CrtA 

000 IK 00 


cacoouA 

IA7AI 

00620CU 

011757 

177773X 

STA 

000 IK no 
14757 YHLD 

014757iiFA 

UCCOOO 

OOOOOCA 

14742 

006200b 

C73760 

177773X 

LDX 

COOIKOO 
14760 M5 

01476C5FA 

177773 

OOOOOOA 

14743 

0062003 
1 05 76 1 

177773X 

LDA* 

COOIKOO 
14761 YDAC 

014770EFA 

054775 

1 74700A 
14744 * 

0062003 

023757 

177773X 

CAS 

OOOIXCO 
14757 YHLU 

014757EFA 

OOOOOO 

174700A 
14 747 

006200a 

024000 

177773X 

IAS 

OOOIXCO 

oooor 

OOOOOOEFA 

OOOOCO 


(b) Example. 

Figure 13. - Sequencing and use of XDEBUG command routine. 




♦-X: XI 


174700A 
1 4 74 0 XXX 

006200b 

140G4C 

177773X 

C.lA 

CUOIXCO 


Pt 

174700A 

14750 

0062QUb 

003743 

177774X 

jr-.p 

OCOIKOO 

14743 

014743c;FA 

105761 

AP: YHLD 
MT 

0062U0A 

14747 

006200b 

024000 

177774X 

IrfS 

too IK 00 
CCOC.O 

CCOOOCEKA 

00(H)OC 

T 

PV 

014400A 
14753 X2 

0C6200b 

121735 

oooooox 

JST* 

0001 KOC 
14735 

015000EFA 

015000 

T 

py 

0144Q0A 

15001 

0C6200b 
025 000 

uooooox 

IRS 

OOOIXOC 
15000 YYY 

015C0CEFA 
U1 4754 

t 

py 

Q14400A 

150Q2 

C06200O 

025000 

oooooox 

IriS 

OOCIKOO 
15000 YYY 

01 5U CCFA 
014755 

T 

014400A 
14740 XXX 

006200O 

140040 

OOOOOOX 

CfiA 

0(101X00 


(NOTE: AT THIS POINT Si 

:nse suiich 1 IS ecsET) 


OT 

C SET 014752 

PV 

0M400A 006200b 

14753 X2 121735 

OOOOOOX 

JST* 

1001X00 

14735 

015000EFA 

015000 

Ct 

PV 

014400A 

15001 

006200b 

025000 

OOOOOOX 
I. -is 

OOOIKOO 
15000 YYY 

015000EFA 

014754 


R 


(b) Concluded. 
Figure 13. - Concluded. 


step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 

S 


S: 

2 

Enters SDEBUG from command structure 

2 

Address" 

SPACE 


3 

Specifies breakpoint location 

3 

SPACE 


SR? 

4 

Options indicated 

4a 

S 


Dispiay 

Return 

Specifies set-breakpoint option 

Hb 

R 


Dispiay 

Return 

Specifies delete-breakpoint option 


®See table IX. 


Figure 14 - Sequencing of SDEBUG command routine. 
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Step 

Enter 

Terminate 

Response 

Go to step- 

1 

R 


R; 

2 

2 

Address® 

SPACE 


3 

3a 

- 



4 

3b 

SPACE 



5 

4 

Address^ 

SPACE 


5 

5 



Return 

— 


®See table IX. 


Description 

Enters RDEBUG from command structure 
Specifies return address 

Indicates initial-condition routine to be executed 
Indicates a direct return 
Calls routine specified by entry 
Transfers program control to return address 


(a) Sequencing. 


xxx.xi+c 

Srt 7 S 

■C147/I2 = '073761, 

-P: » ,7 

1^742 120020 JST» 00020 025504 

XI 

BI-- '014742 
*"S ! a1+2 
S.< ? d 


'014742 = '073760 

-a: XI *-YYY.Y2+l Ab 


(b) Example. 

Figure 15. - Sequencing and use of RDEBUG command routine. 


Step 

Enter 

Terminate 

Response 

Go to step- 

Description 

1 

I 


T: 

2 

Enters TDEBUG from command structure 

2 

Address^ 

SPACE 


3 

Specifies first address of memory to be transferred 

3a 

SPACE 



5 

Transfers only single location 

3b 


— 


4 

Indicates transfer of a memory area 

4 

Address^ 

SPACE 


5 

Specifies last address of memory to be transferred 

5a 

P 


UNIT = 

9 

Indicates transfer to output device 

5b 

V 


UNiT = 

9 

Indicates verification against input device 

5c 

L 


UNIT" 

9 

Indicates transfer from input device 

5d 

M 


T: 

6 

Indicates transfer to memory 

6 

Address^ 

SPACE 


7 

Specifies start of location to receive transfer 

7 

SPACE 


MASK" 

8 

Indicates no specification of last-address counter 

8 

Octal 

SPACE 


Return 

Specifies six-digit octal mask and transfer 

9 

Octal 

SPACE 


Return 

Specifies octal device number and transfer or verify 


^See table IX. 


(a) Sequencing. 

«-T: XXX.SbAT *-XyX.Sl.AT+4 


• IPLV? ny: '15040 
.A3K= '177777 


♦-F: /. 

XX. 00 

Al •“XXX. 

14770 

r 

174700 

14771 

= 

006200 

14772 


OllOfO 

14773 

= 

C144L0 

14774 


0144CC 

*-h: ' 

1504 C’ 

15(.4( 

15040 

= 

174 700 

15C41 


00620O 

15042 

= 

011300 

15C43 


014400 

15C44 

= 

014400 


‘-T; SUAT •-SbAT+4 
..f-LV? F UNIT= '2 
-1; SLiAT «-SbAT+4 
IJFLV? V J^aT= '1 
*-i SuAT 

«-T ! SjAT «-bI'Mi+4 
•;PLV? L ’uMT= 'I 


(b) Example. 

Figure 16. - Sequencing and use of TDEBUG command routine. 




(b) Debug commands. 


Figure 17. - INFORM/debug command structure. 




























Figure 18. - Functional diagram of INFORM/debug initialization command (YDEBUG). 




















Figure 19. - Functional diagram of source-name table input command (UDEBUG). 
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Figure 20. - Functional diagram of intersector reference statistics input command (BDEBUG). 
















Figure 2L - Functional diagram of display command (PDEBUG). 
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Figure 22. - Functional diagram of register/memory change command (CDEBUG). 





















I 



Figure 23. - Functional diagram of program addition command (ADEBUG). 



Figure 24. - Functional diagram of subroutine specification and execution 
command (VDEBUGI. 
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Figure 25. - Functional diagram of execution command (XDEBUG). 
















Figure 25. - Continued. 













































Figure 26. - Functional diagram of breakpoint command (SDEBUG). 























Figure 27. - Functional diagram of program return instruction (RDEBUG). 












Figure 28. - Functional diagram of data transfer command (TDEBUG). 

















I 



(a) Part KPTCH). 

Figure 29. - Functional diagram of debug assembler. 
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Enter CMDI from PTCH 


Is ITXX) greater than length Yes 
of instruction buffer? 


Advise operator error 
exit CMDI 


Ciear instruction word; 
set character counter to -3 


Instruction character 

input 


Instruction character decoder 


Is character counter 
= -3? 



Shift instruction word left 
5 bits and add character 


Search instruction set 
for mnemonic. Return 
with op-code and type 

(FNDI) 


Store octai entry in 
instruction word 


Store octai entry 
indicator [CODOl in address 
word 


6i 




(b) Part II (CMDI). 
Figure 29. - Continued. 



















(b) Continued. 
Figure 29. - Continued. 
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(b) Continued. 
Figure 29. - Continued. 















0 


DEC pseudo-op 


Operator decimal data entry 
(HYR) 


FPC pseudo-op 


Operator decimal data entry 
CTTYR) 


DPC pseudo-op 


Operator decimal data entry 
(TTYR) 


Enter CKS2 


No 


Did operator terminate decimal 
data entry with a “SPACE"? 


Exit CKS2 


Yes 


Did operator terminate decimal 
data entry with a '7 “? 


No 


1 


[ Save deci ma I data entry 


1 


Operator input of scale 
factor reference 

(GSFR) 


Entry 


Default 


Error 


Divide floating-point decimal 
data entry by floating-point 
scale-factor reference 


I 


Store result in decimal 
data entry location 

I Exit CKS2 


Call decimal data 
termination decoder 


(CKS2) 


Convert to integer data 

(C*21) 


Call decimal data 
termination decoder (CKS2) 


Store most significant word 
of floating-point data In 
instruction buffer location 
specified by [TXXl- Store 
floating-point indicator ICOD2] 
in corresponding address 
buffer location. 


Call decimal data 
termination decoder (CKS2) 


Convert to double-precision 
data 

{C$24) 


Yes 


Store most significant word of 
double-precision data in in- 
struction buffer location speci- 
fied by ITXXl. Store double- 
precision indicator ICOD41 in 
corresponding address buffer 
location. 


Error exit CMDI 


Set [MAX] = (TXXJ 


Store integer data In instruction 
word. Store decimal data 
indicator ICODll in address word. 


Store least significant 
word in Instruction 
word. Store ICOD21 
in address word. 


Increment 


ITXX] 


Is (TXXl greater than length 
of instruction buffer? 


No 


[Yes 

Advise operator error exit 
(CMDI) 


Yes 


Is (TXXl greater than length 
of instruction buffer? 


No 


Store least significant 
word in instruction 
word. Store (COD41 
in address word. 
Increment (TXXl 




Store instruction word in 
instruction buffer word 
specified by [TXX] 


) 

store address word in 
corresponding address 
buffer word 






Z] 


Is ITXX] greater than 
location counter (MAXI? 


Print (TXXl 




I No 


Normal exit CMDI 


(b) Concluded. 
Figure 29. - Continued. 



Enter ASEM from PTCH 


Store location where assembled 
program is to be Ixated in IPBBSl 


Store sector number of 
IPBBSl in ISSBVi 


Set instruction buffer 
index ITXXI and assembler 
buffer index IXXTl to zero 

i 

Store instruction counter 
IMAXI in instruction 
limit ITMAXI 


Set intersector bias counters 
to zero 

lABIOIIABIlllABia 


Increment IXXTl and ITXXlf- 


Is 1TXX1> ITMAXI? 


lYesr 


Exit ASEM 


I No 


Store sector number of 
IPBBSl + ITXXI in ISSVQ 


Is the content of the 
address buffer location 
specified by ITXXI <0? 


No (memory-reference instruction) 


Yes 


Is it < -64 


No 




Yes (other data and 
instructions) 


Store content of instruction buffer 
location specified by ITXXI in as- 
sembler buffer location specified 
by IXXTl 


Merge content of 
address buffer with 
content of corresponding 
instruction buffer location 
to form shift instruction 


Store instruction in assembler 
buffer location specified 
by IXXTl 






) 

Is sector of address 
specified by ITXXI - 
sector 0 ? 


1 

[no 

^ No 

Is sector same as 
specified by ISSVEI? 



Yes 


I Yes 


Set sector bit of instruction 
specified by [TXXI 


Reset sector bit of instruction 
specified by ITXXI 


Merge instruction with 
corresponding 9-bit address 
and store in assembler 
buffer location specified 
by IXXTl 


(c) Part III (ASEM). 
Figure 29. - Continued. 
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(c) Concluded. 
Figure 29. - Concluded. 











































Figure 30. - Functional diagram of instruction list routine (LIST). 



























Figure 31. - Functional diagram of instruction search routines (FNDI) and (FNDM). 






































Figure 32. - Functional diagram of scale-factor input routine IGSFR). 

























-J 

o 



Figure 33. - Functional diagram of determination routine for intersector 
reference locations (SBSE). 



Figure 34. - Functional diagram of assembler buffer transfer routine (TRAN). 


































Figure 35. - Operator address-counter and command-specification routine (CMMP). 

















Figure 36. - Functional diagram of current-program indicator and relocation -base 
initialization routine (CSET). 

















Figure 37. - Functional diagram of operator address entry and verification routines (GETN), (ADRS), and (CMCK). 




















Set internal address bias 
[BIAl to zero. Reset assembler 
address indicators (bits 15 and 
16 of [MAS Kl, reset address 
indexing indicator (INDXl 



Figure 38. - Functional diagram of common address input routine (GETA). 
















Figure 38. - Continued. 
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Figure 38. - Concluded 
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Figure 39. - Functional diagram of name-command specification routine (NAME). 












Figure 40. - Functional diagram of name table search routines (NFIN) and FIND). 
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